Get Wallet API Reference

Get Wallet

Returns information about a specific wallet on a given blockchain, including its public key, address, status, and authorization groups.

Request

GET /wallets/{address}?blockchainId={blockchainId}

For example, if your node is running at https://tn-w-1.uledger.net/, the full URL is:
https://tn-w-1.uledger.net//wallets/{address}?blockchainId={ blockchainId}

Path & query parameters

• address – Wallet address to look up.
• blockchainId – ID of the blockchain where this wallet exists.

Response

The response is a wallet object with the following fields:

• publicKey – Hex-encoded public key associated with the wallet.
• address – Wallet address (lookup key for this endpoint).
• parent – Parent wallet, if any (empty string when not used).
• enabled – Whether this wallet is currently enabled.
• satelliteWallets – Array of linked “satellite” wallets (empty if none).
• authGroups – Object describing permissions for logical groups, such as Wallet with create/read/update/delete flags.
• keyType – Type of key used for this wallet (e.g. secp256k1).

Example response

{

"publicKey": "PUBLIC_KEY_HEX_HERE",
"address": "WALLET_ADDRESS_HERE",
"parent": "",
"enabled": true,
"satelliteWallets": [],
"authGroups": {
"Wallet": {
"create": false,
"read": true,
"update": true,
"delete": false
}
},
"keyType": "secp256k1"
}

cURL

curl -X GET -L https://tn-w-1.uledger.net//wallets/{address}?blockchainId={blockchainId} | jq

// Using native fetch (Node 18+)

const nodeUrl = "https://tn-w-1.uledger.net/";
const address = "<WALLET_ADDRESS>";
const blockchainId = "<BLOCKCHAIN_ID>";

const url = new URL(`${nodeUrl}/wallets/${address}`);
url.searchParams.set("blockchainId", blockchainId);

const res = await fetch(url.toString(), {
headers: { Accept: "application/json" },
});

if (!res.ok) {
throw new Error(`Request failed with status ${res.status}`);
}

const wallet = await res.json();

console.log("Address:", wallet.address);
console.log("Enabled:", wallet.enabled);
console.log("Key type:", wallet.keyType);

import requests

node_url = "https://tn-w-1.uledger.net/"
address = "<WALLET_ADDRESS>"
blockchain_id = "<BLOCKCHAIN_ID>"

resp = requests.get(
f"{node_url}/wallets/{address}",
params={"blockchainId": blockchain_id},
headers={"Accept": "application/json"},
)
resp.raise_for_status()

wallet = resp.json()

print("Address:", wallet["address"])
print("Enabled:", wallet["enabled"])
print("Key type:", wallet["keyType"])